Purpose

Transform claude-code-docs from a shell-script-only tool into a native Claude Code Plugin. This gives users a zero-dependency installation path, an auto-discovery Skill that proactively searches docs without requiring /docs, and session-start auto-updates.

What Changed

New: Plugin Structure (plugin/)

Updated: Existing Files

Key Fixes

• URL mapping rules: Corrected filename-to-URL conversion in all plugin instruction files
  • claude-code__<page>.md → https://code.claude.com/docs/en/<page>
  • docs__en__<section>__<page>.md → https://platform.claude.com/en/docs/<section>/<page>
• Broken domain references: Eliminated all docs.anthropic.com and docs.claude.com citations (these domains are dead/wrong)
• CLAUDE.md example URLs: Fixed docs.claude.com → platform.claude.com throughout

Why This Matters

Eval results (6 evals, with-skill vs without-skill):

The skill's primary value is URL mapping guidance. Without the skill, Claude consistently generates plausible-looking but broken citation URLs (docs.anthropic.com, docs.claude.com). With the skill, every URL is correct.

Plugin vs Script Install

Test Plan

• All 303 existing tests pass (no regressions)
• 6 skill quality evals pass at 100% with-skill
• URL mapping produces correct domains for both claude-code__ and docs__en__ files
• No broken domain references in any plugin instruction file
• .gitignore excludes eval workspace and .env
• Plan documents untracked (already gitignored)
• Plugin installation via /install-plugin costiash/claude-code-docs verified locally
• SessionStart hook clones docs on first run, pulls on subsequent runs